home *** CD-ROM | disk | FTP | other *** search
/ Workbench Add-On / Workbench Add-On - Volume 1.iso / BBS-Archive / Dev / ACE_SubMod.lha / wbarg.lha / ReadMe < prev    next >
Text File  |  1994-12-30  |  2KB  |  48 lines
  1.  
  2. Greetings ACE programmer!
  3.  
  4. This is my first attempt at producing a non-toy ACE subprogram library module.
  5.  
  6. The essential files are: WBarg.o and WBarg.h. Notice that WBarg.h here is NOT the same
  7. as ACEinclude:WBarg.h! Its basic purpose is to provide external declarations to the
  8. subprograms in WBarg.o. The latter is an object module that must be linked with a 
  9. program wishing to use any of the subprograms externally declared in WBarg.h. Use the
  10. simple "Make" shell script, eg. make test, for this purpose.
  11.  
  12. WBarg.o contains subprograms to handle Workbench arguments (as documented in ace.doc) 
  13. and tooltypes (not provided before). There is also a function which returns true or
  14. false depending upon whether the program was Workbench-launched.
  15.  
  16. The file WBarg.b contains the source code to WBarg.o. If you don't understand the 
  17. references to a "kludge" in WBarg.b and WBarg.h, don't worry, it's better not to 
  18. know. :-) This won't be an issue in the next release of ACE anyway...
  19.  
  20. The test files consist of:
  21.  
  22.     test.b
  23.     test        '..the executable
  24.     test.info
  25.     arg1.info
  26.     arg2.info
  27.     arg3.info
  28.  
  29. To see what the program does, create a temporary drawer from the Workbench, copy
  30. these files into it and experiment. See the comments at the top of test.b for more.
  31.  
  32. After playing with the program, go take a look at the source files: WBarg.b, WBarg.h,
  33. test.b (probably in the reverse of that order).
  34.  
  35. If you use WB arguments and/or tooltypes in your ACE programs a lot, or you'd like
  36. to, well, now you can! You can even add WBarg.o to the list of library modules in
  37. the Blink entry of the bas script if you like.
  38.  
  39. I'll admit that creating subprogram library modules is not as straightforward as
  40. it should be right now. I'm working on it though. At least _using_ them is fairly
  41. easy given the appropriate ".h" file.
  42.  
  43. All comments are welcome.
  44.  
  45. Regards,
  46.  
  47. David Benn, 30th December 1994
  48.